home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr15 / gifsze15.zip / GIFSIZE.DOC < prev    next >
Text File  |  1993-05-22  |  12KB  |  290 lines
  1.  
  2.  
  3.                           G I F S I Z E 
  4.  
  5.                            Version 1.5
  6.                          May 20 ,  1993
  7.      
  8.           A Resizing Program for Your GIF(tm) Pictures
  9.            Copyright 1990,1993 Synergrafix Consulting,
  10.                       All rights reserved. 
  11.  
  12.      GIFSIZE is produced by:
  13.  
  14.            Steve Enns                Synergrafix Consulting 
  15.         44 Macdermid Cres.             44 Macdermid Cres. 
  16.           Saskatoon, Sk.                 Saskatoon, Sk. 
  17.           Canada S7J 2R2                 Canada S7J 2R2 
  18.  
  19.      This document has been stolen from the original GIFWARP!
  20.      document - if you have GIFWARP!, all the "humor" in here    
  21.      is ginna' seem familiar...
  22.  
  23.      Our motto:
  24.      
  25.      "We endeavour to pursue faithfully the highest principles in
  26.      sophisticated program design and development - until we're
  27.      offered more money or more exciting jobs."
  28.  
  29.      Top Ten Phrases heard around this lab:
  30.  
  31.                "What does `File Allocation Table Bad' mean?"
  32.                "Where was that bottle?"
  33.                "Sure it's weird, but will it sell?"
  34.                "Are these deductions right?"
  35.                "Where's that Stones tape?"
  36.                "Yah, C is okay, but can you do it in FORTRAN?"
  37.                "Where was that bottle?"
  38.                "I thought YOU fed the sled dogs!"
  39.                "Error handling?  What's that?"
  40.                "Where was that bottle?"
  41.  
  42.      Okay, here's the boring stuff, but don't worry, it's better
  43.      than chewing tinfoil:
  44.  
  45. ACKNOWLEDGEMENTS
  46.  
  47.      Kudos, thanks, and good karma to John Bridges for the
  48.      enlightening information and code contained in his VGAKIT
  49.      package.  Trademarks like GIF(tm) and PC(tm) are held by
  50.      their respective companies. 
  51.  
  52. DISCLAIMER
  53.  
  54.      The GIFSIZE program is provided without warranty of any
  55.      kind.  The user of the GIFSIZE assumes complete
  56.      responsibility for any and all incidental or consequential
  57.      damages which may occur during normal or abnormal use of the
  58.      GIFSIZE program.  Use the GIFSIZE program at your own risk.
  59.  
  60. LICENSE 
  61.  
  62.      The entire GIFSIZE package, including the GIFSIZE program,
  63.      documentation, and sample files are Copyright 1990,1993 
  64.      Synergrafix Consulting.  All rights reserved.  The
  65.      unregistered shareware version of the GIFSIZE may be freely
  66.      distributed to others by any means, as long the following
  67.      (three) conditions are met:
  68.  
  69.           1) GIFSIZE is distributed in a "package" containing    
  70.           the following three files:
  71.                               GIFSIZE.EXE
  72.                               GIFSIZE.DOC
  73.                               GS-READ.ME
  74.           
  75.           2) GIFSIZE is not distributed as part of any other     
  76.           product, except with specific written permission from
  77.           the author, Steve Enns.
  78.  
  79.           3) NO fee of any kind is charged for the GIFSIZE
  80.           package or for the service of providing the package,
  81.           except Computer Bulletin Board Systems, which may
  82.           distribute the GIFSIZE package even though they may
  83.           charge a membership or service fee.
  84.  
  85.      You can use the "shareware" version for as long as you want,
  86.      even until you're well into your nineties, but you are of
  87.      course encouraged to send us lots of money, too. (I'm
  88.      struggling to pay for my violin lessons, and Dan needs a new
  89.      fishing rod.)  On the other hand, a "registered" version of
  90.      GIFSIZE is available from the authors for $8.00 U.S.  The
  91.      registered version provides support for 512K and 1024K
  92.      SuperVGA cards from most manufacturers (see REQUIREMENTS
  93.      below).  The registered version is licensed to the purchaser
  94.      exclusively, and may not be distributed to others.  To      
  95.      order the SuperVGA version of GIFSIZE, send $8.00 U.S.      
  96.      to the "Steve Enns" guy mentioned above.  You will receive a
  97.      5.25" (sorry NO 3.5" disks!) disk with the latest SuperVGA  
  98.      version of GIFSIZE.  If you send $23.00 or more, you will   
  99.      also receive the licensed SuperVGA versions of:
  100.  
  101.           GIFWARP!  Warp, bend or stretch your GIF(tm) pictures
  102.                     for bizarre and interesting effects.
  103.  
  104.           GIFCLIP   Clip/Crop parts from your GIFs.  Add text or
  105.                     your own GIF(tm) logos to your pictures.
  106.  
  107.           GIFEXE    Make your GIF(tm) into an executable program
  108.                     with special effects.  Just run the program
  109.                     to display the picture.  Great for demos or
  110.                     displays or title screens for your programs. 
  111.                     Supports SuperVGA.
  112.  
  113.      Look for the unlicensed shareware versions of GIFCLIP,
  114.      GIFWARP! and GIFEXE on your favourite bulletin board system.
  115.  
  116.  
  117. REQUIREMENTS
  118.  
  119.           GIFSIZE requires the following:
  120.  
  121.                -    PC(tm)/XT(tm)/AT(tm)/386(tm) computer thing
  122.                -    About 280K of free RAM
  123.                -    DOS 3.0-6.0 (others untested)
  124.                -    A mouse that at least claims to be
  125.                          compatible with something
  126.                -    A VGA or SuperVGA card
  127.  
  128.           and optionally:
  129.  
  130.                -    SuperVGA - The registered SuperVGA version of
  131.                     GIFSIZE supports modes like 640x480, 800x600
  132.                     and 1024x768 with 256 colours on 512K and 1024K
  133.                     SuperVGA cards from ATI, Ahead, Cirrus, Chips and
  134.                     Technologies, Everex, OAK, Paradise, Trident,
  135.                     Tseng, Video7, Compaq, NCR, Genoa and VESA. 
  136.                     (S3 based cards with (bug free!) bioses are now
  137.             fully supported.) See the LICENSE section above
  138.             for ordering information.
  139.  
  140. INSTALLATION
  141.  
  142.      Copy the GIFSIZE program (and this helpful document of
  143.      course!) to any directory that you want - perhaps with      
  144.      your favourite GIF(tm) viewer somewhere in the DOS          
  145.      path.
  146.  
  147. USAGE
  148.  
  149.      Syntax for GIFSIZE is as follows:
  150.  
  151.           GIFSIZE [?] infilename[.GIF] [outfilename[.GIF]]
  152.                          [/autoscale]
  153.  
  154.      or
  155.  
  156.           GIFSIZE [?] infilename[.GIF] [outfilename[.GIF]]
  157.                     [/mode={0,1,2,3,4}] [/autoscale]
  158.  
  159.      for the registered version.  ( The /mode=n parameters are as
  160.      follows:       /mode=0        Ordinary 320x200 mode
  161.                     /mode=1        Low resolution SVGA
  162.                                         640x400 or 640x350
  163.                                         depending on your card.
  164.                     /mode=2        Medium resolution 640x480
  165.                     /mode=3        High resolution 800x600 
  166.                     /mode=4        Higher resolution 1024x768
  167.                                    supported on some 1024K cards.
  168.                    (Try a VESA driver!)
  169.  
  170.      The /autoscale option trys to fir the GIF onto the screen
  171.      when the specified screen mode is much larger then the GIF. 
  172.                                                   
  173.      For example, try:
  174.  
  175.           C> GIFSIZE               to see the title screen
  176.  
  177.           C> GIFSIZE ?             to see the help/brag screen
  178.  
  179.           C> GIFSIZE house         to view/resize the file
  180.                                    HOUSE.GIF writing the resized
  181.                                    picture (if any) to the 
  182.                                    default name GIFSIZE.GIF
  183.  
  184.           C> GIFSIZE house house2  view/size the file HOUSE.GIF,
  185.                                    writing output to HOUSE2.GIF
  186.                
  187.      With the registered version:
  188.  
  189.           C> GIFSIZE car /mode=2   View/size CAR.GIF using medium
  190.                                    resolution SuperVGA
  191.                               
  192. TUTORIAL
  193.  
  194.      Try out the following with your favourite GIF(tm) picture:
  195.  
  196.                C> GIFSIZE picturename
  197.  
  198.      GIFSIZE will load the picture and display it one your
  199.      screen.  The mouse cursor will appear in the centre of the
  200.      picture along with the coordinates of the current position. 
  201.      Choose the area of the picture that you want to resize by
  202.      pressing and holding down the left mouse button while moving
  203.      the mouse.  This "clipping box" will move as you move the
  204.      mouse.  Release the left button when the "clipping box" is
  205.      the appropriate size.  Now choose another box in the same
  206.      way.  The second box may be bigger or larger than the first
  207.      box, and may be anywhere on the screen.  When you chosen two
  208.      boxes,  press the right mouse button.  The area of the
  209.      picture that you chose with the first box will be resized   
  210.      to fit into the second box.  Any number of these resizings
  211.      may be done.  When you are done, press the <ENTER> key, and
  212.      the last resized image will be saved.  If you want to exit
  213.      GIFSIZE without saving the resized picture, press the <ESC>
  214.      key. 
  215.  
  216.  
  217. ERRORS
  218.  
  219.      - The following self explanatory error messages may be
  220.      produced by GIFSIZE.  The errors involving the GIF(tm) files
  221.      will generally be due to disk errors or faulty image files. 
  222.      Other errors refer to lack of enough free RAM space, or lack
  223.      of required hardware (VGA and Mouse).
  224.  
  225.           Can't initialize VGA graphics!
  226.           Mouse driver not installed.
  227.           Can't allocate mouse memory!
  228.           Unexpected EOF reading GIF!
  229.           Premature end of GIF!
  230.           Not GIF file!
  231.           Invalid GIF format
  232.           Error writing GIF!
  233.           Buffer allocation failure!
  234.           Can't continue - you're not smiling!
  235.           
  236. NOTES
  237.  
  238.      - GIFSIZE reads both GIF87A standard (the original) and     
  239.      new GIF89A pictures, although most of the extensions in the
  240.      new GIF89A standard like (silly) text windows are ignored. 
  241.      The last image in multi-image GIFs will be the one displayed
  242.      for resizing in GIFSIZE.
  243.  
  244.      - Although only the registered copy of GIFSIZE provides     
  245.      full SuperVGA resolution, all GIF pictures can be decoded   
  246.      and displayed on all versions of GIFSIZE.  If the image is  
  247.      too large for the available resolution, the image will be   
  248.      centred on the screen.  You will see the middle 320x200     
  249.      pixels of the image when the entire image is larger than    
  250.      320x200, for example.  The registered version of GIFSIZE    
  251.      will display images at resolutions up to 1024x768 according
  252.      to the size of the picture, or the specified mode.
  253.  
  254. HISTORY
  255.  
  256.      - Version 1.0 Completed July.10 1991
  257.  
  258.      - Version 1.2 Completed Sep.15 1991
  259.           Support for some additional cards and 1024x768x256 on
  260.           some 1024K cards, due to Bridges' new VGAKIT35 package.
  261.      
  262.      - Version 1.3 Completed Sep.20 1991
  263.           /autoscale is now an option
  264.  
  265.      - Version 1.4 BIG 'OL BUG which disabled VGA in registered
  266.           versions is now fixed.
  267.  
  268.      - Version 1.5 Completed May.20 1993
  269.       Support for more graphics hardware, including much 
  270.       more extensive VESA support.  S3 and other Windows
  271.       accelerator cards which support VESA are now supported.
  272.  
  273. PROPOSED FUTURE ENHANCHMENTS
  274.  
  275.      - Support for other graphics hardware.  Hopefully, we will
  276.      be able to support new hardware and graphics modes as they
  277.      are introduced.
  278.  
  279.      - Faster GIF(tm) decoding and encoding
  280.  
  281.      - Allow resizing to areas larger than the screen
  282.  
  283.      - Resize according to command line arguments, for batch mode
  284.      resizing
  285.  
  286.      - You tell me!
  287.  
  288.  
  289.  
  290.